home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / tshare.arc / WKB.DOC < prev   
Encoding:
Text File  |  1985-10-23  |  10.5 KB  |  263 lines
  1.                /=================\
  2.                | Window Keyboard |                (1.6)
  3.                \=================/
  4.             
  5.             Marty Ross
  6.             c/o Computing Resource Center
  7.             10801 National Blvd., Third Floor
  8.             Los Angeles, CA  90064
  9.  
  10.  
  11. Release:    1.6, 10/18/85
  12. By:            Marty Ross
  13. Requirements:    Tested using PC-DOS 2.0/2.1
  14.  
  15. Description:    Window Keyboard is a general IBM-PC keyboard enhancement which
  16.         provides two functions: larger keyboard typeahead buffer (250
  17.         characters), and a dynamic keyboard input window area which 
  18.         shows the current typeahead line on the screen, taking some of
  19.         the guesswork out of typeahead.  
  20.  
  21.         After being activated, the program can easily be enabled or 
  22.         disabled by use of the [PrtSc] key to toggle it on/off.  The 
  23.         use of the [PrtSc] key is an option, however; WKB can be toggled
  24.         directly from DOS as well.  When enabled, the program almost
  25.         perfectly emulates the BIOS keyboard, so many applications will
  26.         work perfectly (including the use of the function keys, etc).
  27.         See the technical discussion below for differences.
  28.  
  29.         It is designed specifically to emulate VMTERM's (CRC terminal 
  30.         eumlator, 1983) keyboard, and may be used in conjunction with 
  31.         TSHARE (timesliced terminal emulator, 1984, ver 2.6 on) to
  32.         provide the keyboard component of VMTERM.
  33.  
  34.  
  35. Distribution:    I am distributing this preliminery version freely, in hopes to
  36.         stimulate interest and feedback.  No fee may be charged for its
  37.         distribution, and this document must accompany the programs 
  38.         documented herein. 
  39.  
  40.  
  41. Usage:        Window Keyboard should be installed before any other keyboard
  42.         enhancements (other drivers, INCLUDING TSHARE), because it
  43.         needs complete control of the original BIOS keyboard.  To be
  44.         safe, first boot up a fresh version of PC-DOS, then invoke the
  45.         WKB command with desired options and window size to activate the 
  46.         window keyboard.  Then go ahead and load on the other keyboard 
  47.         drivers necessary.  Depending upon the options specified, WKB
  48.         may not become immediately active.  If not, use the [PrtSc] key
  49.         to activate or de-activate WKB once installed.
  50.  
  51. Syntax:        wkb [-option(s)] [window size]
  52.  
  53.  
  54.         WKB options:
  55.                 I - Increment window "home" position
  56.                 P - Pass attention through
  57.                 T - Toggle window keyboard on/off
  58.                 X - Do not intercept [PrtSc]
  59.  
  60.         window size:
  61.                 0 - No visible window
  62.                 1 - One line window
  63.                 2 - Two line window
  64.                 3 - Three line window
  65.  
  66.         I will not go into the details of each here; however, the "P" 
  67.         option may not have an obvious effect: it causes your [PrtSc]
  68.         key to activate not only WKB, but whatever existed as a
  69.         function of that key before WKB was activated.  The "X" option
  70.         has an additional effect: WKB will ignore the [PrtSc] key,
  71.         causing it to revert to its old meaning (possibly to print the
  72.         screen, if no other software has taken it).  
  73.  
  74.         To refresh your memory after learning about WKB, or for
  75.         complete syntax rules for activating WKB, type "WKB ?"
  76.         in DOS for a help screen.  The same applies to the TSHARE 
  77.         program and other related drivers.
  78.  
  79.         An example:
  80.  
  81.         +---------------------------------------------------------+
  82.         |                              |
  83.        (1)    |    <ALT>+<CTL>+<DEL> ...                  |
  84.         |                              |
  85.         |    IBM Disk Operating System              |
  86.         |    Version 2.xx ...                  |
  87.         |                              |
  88.        (2)    |    A>wkb 2                          |
  89.         |    WKB - 1.x - (C) Copyright 1985, by Marty Ross      |
  90.         |    Driver Active.                      |
  91.         |                              |
  92.        (3)    |    A>rem WKB can now be activated anytime until      |    
  93.         |    A>rem we re-boot (CTL+ALT+DEL), by pressing       |
  94.         |    A>rem '<SHIFT>+[PrtSc]', unless another program      |
  95.         |    A>rem redefines our interrupts.              |
  96.         |                              |
  97.        (4)    |    A>wkb -tx 2                      |      |
  98.         |    WKB - 1.x - (C) Copyright 1985, by Marty Ross      |
  99.         |    WKB is ON, with 2 reserved lines.            |
  100.         |                              |
  101.        (5)    |    A>rem We did it manually, using WKB to show         |    
  102.         |    A>rem the use of the "T" option (same as presing  |
  103.         |    A>rem the '<SHIFT>+[PrtSc]' keys).          |
  104.         |    A>rem NOTE: Since we used "X" [PrtSc] cannot be      |
  105.         |    A>rem       used; MUST use WKB -t now.          |
  106.         |                              |
  107.            |    A>wkb -t 2                      |      |
  108.         |    WKB - 1.x - 08/01/84 - M.Ross @CRC, (C) 1984      |
  109.         |    WKB is OFF                      |
  110.         |                              |
  111.         +---------------------------------------------------------+
  112.                     Figure 1.
  113.     
  114.         First (1), we made sure we had a fresh DOS, with no other
  115.         keyboard intercepts.  Then we installed a Window Keyboard
  116.         with a two line window(2).  When it returns to DOS(3), we're
  117.         still using our old keyboard, and can toggle into window on
  118.         mode by pressing the [PrtSc] key (may need to hold SHIFT key).
  119.         Alternatively, we can use the "T" (toggle) option of WKB to
  120.         toggle window mode(4).  We will be forced to use the "T" option
  121.         if we ignore the [PrtSc] key by previously using the "X" option.
  122.  
  123.  
  124. Why WKB?:    WKB was written because the typeahead facilities on the IBM-PC
  125.         were not adequate for some of our applications, especially for
  126.         half duplex communication software.  Emulating CRC's VMTERM
  127.         (async communication program) keyboard, WKB provides an enhance-
  128.         ment to TSHARE (background async com program) whereby
  129.         remote users of CRC's mainframe system appear to have zero 
  130.         line turnaround time (their keyboards remain open always).
  131.         The visual feature makes typeahead more reliable, since the
  132.         user can always see the complete typeahead line before 
  133.         pressing enter (and if a line turnaround protocol is used,
  134.         allows local editing of the typeahead line).
  135.  
  136. Technical:    This program intercepts interrupts 10H, 16H, 1BH, 1CH, and 67H: 
  137.  
  138.         08H - Timer - Read BIOS into our buffer & update window
  139.         10H - Screen - Calls: 6, 7, 14; protect window.
  140.         16H - Keyboard - Calls: 0, 1: if "window on", we take over.
  141.         1BH - Break - If "window on", clear window & flush kb buffer.
  142.         67H - Interrupt Communication Vehicle.  Reserved.
  143.  
  144.         When the window is on, our keyboard uses the timer interrupt to
  145.         multiplex the BIOS keyboard typeahead buffer into our own,
  146.         larger storage buffer.  If any characters are read, then the
  147.         window area is updated (if its bigger than zero lines long),
  148.         thus ALWAYS keeping the user aware of what he typed.
  149.  
  150.         The keyboard (INT 16H) behaves identically as before EXCEPT
  151.         that SCAN CODES are NOT returned in AH (unless AL==0, as in
  152.         extended characters -- I bring them through only to save space).
  153.         In future versions, I will dummy up AH always for the benefit
  154.         of those few programs which make use of scan codes for keyboard
  155.         defined characters.
  156.  
  157. Future        Future versions of WKB will necessarily incorporate a screen
  158.   Directions:    driver which will allow multiple windows for foreground/
  159.         background tasks, and ANSI protocol for cursor/screen control.
  160.         Also, a scroll-back feature may be required which will allow
  161.         the user to see up to n pages of previously displayed data.
  162.  
  163. Disclaimer:    Though I've tested WKB under varying conditions, I cannot
  164.         guarantee that it will work in every case/PC configuration.
  165.         Also, I suggest you use caution when using WKB in new
  166.         situations: I will not be liable for any damage caused, but 
  167.         would like to be informed if any undesireable WKB 
  168.         interactions occur.  Please write me.
  169.  
  170.  
  171. About the Author:
  172.  
  173.         Marty Ross is a consultant for the Computing Resource Center,
  174.         a data processing firm in Los Angeles.  CRC uses the IBM VM/SP
  175.         operating system to provide its clients with an interactive
  176.         method to access popular mainframe data handling facilities, 
  177.         such as SAS, PL/1, FORTRAN, and the On-Line Data System, 
  178.         CRC's own database management product.  For microcomputers,
  179.         CRC has released a Statistics/Data Analysis and Graphics
  180.         package for the IBM-PC called STATA, the Data Tool, which 
  181.         features standard statistical (regression) analyses, excellent 
  182.         data handling capabilities, and a wide variety of experimental
  183.         data analysis techniques with STATA/Graphics.  If you are 
  184.         interested in obtaining a DEMO copy of STATA, please call CRC
  185.         on their toll-free number:  1-800-782-8272 outside California,
  186.         or dial them directly at (213) 470-4341.  Be sure to tell them
  187.         that Marty sent you!
  188.  
  189.  
  190. ----------------------------
  191.  
  192. [1]  WKB is not recommended for use with any program which uses BASIC or any  
  193.      if its derivatives (compiled, etc).
  194.  
  195. [2]  Perhaps it is unfortunate that WKB uses the <SHIFT>+[PrtSc] key
  196.      thus disabling it as a "print screen" function.  Remember, however;
  197.      this is only a demonstration program and was not written with profes-
  198.      sional intent.  If enough interest is shown, future versions will 
  199.      be released to those contributing new ideas, free of charge.
  200.  
  201. -----------------------------
  202.  
  203.                /=================\
  204.                | Window Keyboard |                (1.6)
  205.                \=================/
  206.  
  207.             Marty Ross
  208.             c/o Computing Resource Center
  209.             10801 National Blvd., Third Floor
  210.             Los Angeles, CA  90064
  211.  
  212.         
  213.             Release:    1.6, 10/18/85
  214.  
  215.                 Comments?   
  216.                  Can you use WKB?  
  217.  
  218.  
  219. Name:       _________________________________________________________
  220.  
  221.  
  222. Address:    _________________________________________________________
  223.  
  224.             _________________________________________________________
  225.  
  226.             _________________________________________________________
  227.  
  228.  
  229.         ---------------------------------------------------------
  230.         
  231.  
  232. Comments:   _________________________________________________________
  233.  
  234.             _________________________________________________________
  235.  
  236.             _________________________________________________________
  237.  
  238.             _________________________________________________________
  239.  
  240.             _________________________________________________________
  241.  
  242.             _________________________________________________________
  243.  
  244.             _________________________________________________________
  245.  
  246.             _________________________________________________________
  247.  
  248.             _________________________________________________________
  249.  
  250.             _________________________________________________________
  251.  
  252.             _________________________________________________________
  253.  
  254.  
  255.     If you feel WKB contributes to your effectiveness, then please let
  256.     me know by sending a donation of $10.00 or whatever you feel is ap-
  257.     propriate.  WKB was developed in my spare time, and is now not a
  258.     commercial effort of CRC.  I will continue to develop products like
  259.     WKB for those who show interest - provided I can afford it.  Users
  260.     who make contributions will be entitled to a single sided diskette
  261.     of other utilities I've developed while at CRC: please include your
  262.     name and return address when sending donations!
  263.